home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / moref241.zip / MORE.DOC < prev    next >
Text File  |  1990-03-27  |  28KB  |  661 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                          MORE
  8.                                              
  9.                                A Unix-like file browser
  10.                                           by
  11.                                      Fred C. Smith
  12.                
  13.                
  14.                HISTORY
  15.                In late 1984 Dr. Dobbs Journal published Allen Holub's
  16.             version of GREP. I ported Mr. Holub's version of GREP to run
  17.             on the micro-based workstation that was the environment in
  18.             which I was currently working, and quickly found it to be
  19.             indispensable.
  20.                That, of course, just whetted my appetite for more useful
  21.             programs. I was particularly interested in having a program
  22.             like Unix's MORE, which is sort of a super file browser. The
  23.             workstation I was using had a tool called TYPE (aren't they
  24.             all?), which while much better than nothing, just wasn't as
  25.             good as MORE. It did nothing more than display on the
  26.             terminal one screenfull at a time of text.
  27.                I kept waiting, hoping in vain that Dr. Dobbs would
  28.             publish a follow-up article after GREP, giving me a version
  29.             of MORE. Before too long, however, anticipation got the
  30.             better of me and I decided to write my own.
  31.                
  32.                DESCRIPTION
  33.                Although my version of more has been ported to several
  34.             different environments, this document describes only the
  35.             version for MS-DOS/PC-DOS.
  36.                More is a file browser with a number of interesting and
  37.             useful features. Besides simply displaying a file a
  38.             screenfull at a time, MORE allows scrolling in half
  39.             screenfulls, and a line at a time. It will display an entire
  40.             list of files, one at a time, and can skip forward to the
  41.             next file on the list (without completing the current file,
  42.             if you choose), jump back to the beginning of the current
  43.             file, the beginning of the previous file, skip a specified
  44.             number of screenfulls of the current file, search through
  45.             each file in the list for a specified text string.
  46.                The version of MORE given here is not an exact functional
  47.             copy of the Unix version. There are a couple of reasons for
  48.             that. First, there is more than one version of MORE on Unix,
  49.             depending on which flavor of Unix you have. Second, I did
  50.             not have access to a Unix manual or a Unix system for
  51.             reference at the time I was writing this program. As a
  52.             consequence I first put in those features that I had found
  53.             most useful in the past, then added any others that I could
  54.             remember. However, most of the features found in Unix
  55.             versions of more are here, as well as a few not found on
  56.             Unix.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.    MORE.DOC (V 2.4.1)                                                PAGE 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                As in the Unix versions of MORE, this version will search
  74.             for a line containing a match for a specified regular
  75.             expression (for details on regular expressions, see Figure
  76.             1). This allows searching for sequences of text that match
  77.             some specified pattern, rather than a particular character
  78.             sequence.
  79.                A variance from the Unix `standard' version of MORE (that
  80.             relates to searching) is that in the Unix versions that I
  81.             have used, when using the 'n' command to repeat the previous
  82.             search, the search begins at the first line off the bottom
  83.             of the screen. In this version, the search begins at the
  84.             line immediately following the line which contained the
  85.             preceding match, assuming that no other operations have
  86.             occurred since the search. Otherwise, the search begins at
  87.             the first line off the bottom of the screen.
  88.                This version of MORE has another interesting feature not
  89.             seen on most Unix versions, and that is the ability to move
  90.             backwards through a file a screenfull at a time.
  91.                As in the Unix versions, this version pauses at the end
  92.             of each window with a prompt like:
  93.                
  94.                --More--(79%)
  95.                
  96.                The percentage given is the percentage of the current
  97.             input file that has so far been read. If displaying input
  98.             from a pipe, the percentage figure is not displayed.
  99.                This version also contains a help facility. The command
  100.             "h", "H" or "?" causes MORE to print a terse help message on
  101.             the screen, and then return to the prompt.
  102.                Table 1 describes the command line options available in
  103.             MORE. Table 2 gives a detailed explanation of each of the
  104.             commands that are accepted by MORE when it is paused at the
  105.             prompt.
  106.                
  107.                COPYRIGHT INFORMATION
  108.                The regular expression parser in this program is
  109.             excerpted with only minor changes from the GREP distributed
  110.             by DECUS (DEC Users Society). The DECUS code is copyrighted
  111.             by DECUS and may be freely distributed for noncommercial
  112.             purposes only. Some of the low-level routines which access
  113.             the video BIOS are derived from code published in Dr. Dobbs
  114.             Journal by Allen Holub and Jeff Duntemann. The code which
  115.             tests the executable file for corruption (possibly by a
  116.             virus) is derived from code presented in the August 1989 PC
  117.             Magazine "Languages" column. The remainder of the code which
  118.             constitutes this program, as well as the program itself (and
  119.             this documentation), is copyrighted (C) 1986, 1987, 1988,
  120.             1989 by Fred C. Smith. The source is not available, but the
  121.             executable may be freely distributed as long as it is not in
  122.             any way modified and no fee is charged either for the
  123.             program or in connection with its distribution. In plain
  124.             English, I intend for anyone who wants to use my program to
  125.             be able to do so, and I will permit no one to charge any fee
  126.             whatsoever for using or distributing it. My copyright
  127.  
  128.  
  129.  
  130.    MORE.DOC (V 2.4.1)                                                PAGE 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.             banner, and all other messages (including this document)
  140.             must remain as I have made them, without change.
  141.                You may distribute more freely (within the constraints
  142.             outlined in the preceding paragraph), but when you
  143.             distribute it you MUST distribute all the files in the
  144.             original package. Those files are: more.doc (this file),
  145.             more.exe, more.cnf, and any readme files which may be in a
  146.             particular release. All files must remain unmodified. You
  147.             may, of course, modify more.cnf for your own use, but when
  148.             re-distributing more, please use only the original
  149.             unmodified files.
  150.                
  151.                IMPLEMENTATION
  152.                This version of more is a new implementation, independent
  153.             of any versions offered on any variety of Unix system (or,
  154.             for that matter, any other offering). There is no source
  155.             code in common between this and the Unix versions. The only
  156.             commonality is the name and most of the functionality.
  157.                
  158.                USAGE
  159.                more [switches] [file names]
  160.                
  161.                See Table 1 for description of the switches. One or more
  162.             filenames may be given, and DOS wildcards may be used. If no
  163.             files are specified, more will look to standard input for
  164.             data to display. This allows more